§OpenBook§is the "locked" state of Waldo. In this document Waldo will refer to the ShareWare "unlocked" program. OpenBook refers to the commercial "locked" version of the program. OpenBooks are distributed "without" a "per book" royalty of any kind. There is a one time $20 fee ($30 if you have not registered Waldo--Nebraska residents add appropriate state sales tax). This one time fee applies to a single site (address) of a business or a single person--whichever the case may be. If you have already registered your copy of Waldo then your fee is $20.(NOTE: Locked copies of Waldo distributed by a publisher are NOT distributed as ShareWare. Any "unlocked" copies of Waldo ARE distributed as ShareWare.) All users of "unlocked" copies of Waldo are required to register them at $10 per copy. The $20 registration fee entitles the registered user to 1 hour of phone help. When available the registered user will have access to the ARTWAY computer bulletin board. The registered§OpenBook§user may distributed locked Waldos of _new_ versions for a very small extra fee. Registered ShareWare readers/authors/publishers will not be responsable for any further fees, as new versions become available. (All new versions will be available online or on disk for a nominal shipping and handling fee and may be distributed at no extra fee.) Custom versions of Waldo may be ordered and work is done on a per hour basis. If you have any questions please E-mail or send through the Post Office.
^
*|Procedures and Features|*
^
*Switching to OpenBook*
Enter the first password into the message box and a dialog displays asking for a password. (You may change that password.) After the correct password is entered then a dialog gives you several options:
1/ Unlock paint tools--use painting tools
2/ HideGrph--hide or show Page Graphics Button (only aapears in OpenBook)
3/ Show Text menu--show the text menu for editing text
4/ CopyText--allow reader, or disallow reader to copy and print text (OpenBook only)
5/ XStack: Normal/Remote--Remote allows XStacks to be placed on a removable media
6/ Lock Waldo: ShareWare/OpenBook (change from ShareWare to OpenBook)
7/ Set a new password--change your OpenBook password.
^
*OpenBook features*
Several features are available when Waldos are locked. OpenBooks act the same as unlocked Waldos with these exceptions:
1/ You may not load a document into or erase a document while it is locked.
2/ XRes stack scripts operate from within the locked Waldo, HyperQueues that are loaded into Waldo are locked at the same time as Waldo but those Queues not used/occupied are available to the reader as unlocked.
3/ XStacks are accessed from the Waldo level and not the document level.
4/ Stack help is accessed from the Waldo level not the document level.
5/ You may create Page level Graphics.
6/ When doing Page level Graphics you can display a Page Graphics button.
7/ A different (OpenBook) copyright notice is displayed.
8/ You may edit text in OpenBook when the Text menu is in the menubar (OpenBook authors only).
9/ You may change the text style of text loaded into OpenBook:
(italic and 18 point text).
10/ You may "lock out" the reader from copying text/printing text.
^
*OpenBook and XRes*
When you have loaded a document into Waldo and are locking it you are asked to select a file name of a stack. This stack is the XRes, if created by the author, for the Waldo. If you have included resources and/or handlers in the XRes stack then in the get file dialog select the XRes stack and click on "Open." (If you have not included XRes in any HyperQueue you are locking into Waldo choose Cancel.) Next Waldo will load in the script from the XRes stack into the Waldo. XRes handlers are run from within the Waldo. Any resources, sound or picture, are transferred into the Waldo via an XCMD in Waldo. After that point all XRes functions that are accessed from "locked" HyperQueue Queues are run from within the Waldo. If there is no XRes stack associated with locked Queues then click on the "Cancel" button when the select stack dialog is displayed to bypass the XRes script & resource load procedure. HyperQueues added AFTER the WALDO §HAS BEEN LOCKED (OpenBook) still accessed XRes in an external stack§ but at the same level as the OpenBook.
^
*More on XRes*
Now ARTWAY is distributing a FreeWare Copyrighted stack called XHome™ that automates the creation of picture and sound resources and will automatically create an XRes stack--complete with the scripts to run it! No other programs, no programming skills, are needed to create XRes stacks with pcitures and sounds!
§NOTE:§New to Version 3.4.3 XRes names may be up to 20 characters long (the one word restriction still applies) and include any charcaters except commas and any Waldo formatting chacter.
Be sure to follow the instructions for naming and structuring handlers for XRes stacks. When these scripts are loaded into locked Waldos and then run from within OpenBook then any deviation from the standards delineated in the Waldo documentation will cause the Waldo to malfunction. (Actually most all errors in scripting XRes handlers will be caught by error trapping routines the first time a script is run.) Never modify or write a script and then lock Waldo without first running the script to catch any errors!
^
*Page Graphics*
OpenBooks may display Page level Graphics. Type in password into the message box and hit return then enter your password. Click the "Lock" Paint option changes it to unlock. You then click Ok. When the paint tools are unlocked a new button appears on the Front Page ( a hand and a paint brush icon). Click on the button and the Paint tools are locked or return to the OpenBook dialog. When unlocked you may use the paint tools to create graphics directly on the Waldo Page--you _must_ lock the paint tools before distributing the Waldo. There is a defined area on the Front Page where the author may place a logo or other graphics or text to identify your Waldo. The author may place graphics on any other Page, except a Table of Contents Page, covering the text field but no where else!
§NOTE:§Modified Waldos may not be distributed in any form other than in OpenBook locked state!
When you click on a graphic the picture will be hidden and then the text field reacts to the click normally. Click on the Graphic Button to redisplay the Graphic, or go to another Page.
§NOTE:§Be sure to Show the Graphics Button when you are going to use Page Graphics.
§NOTE:§Option/Tab displays/hides the tool pallet. When a Paint tool is selected then Tab displays/hides the pattern pallet.
^
*Text Menu*
Type in password and return into the message box and enter the second password. Click "Hide" the Text Menu option to change it to "Show" and then click Ok. When the Text menu is in the menu bar a new button appears on the Front Page ( a capitol "A" icon). Click on the button and the Text menu is hidden or return to the OpenBook dialog and click on Hide.
The Text menu gives several options:
1/ Italic
2/ Plain
3/ Large
4/ Lock Text
5/ Hide
The first three options will modify any text that has been selected.
§NOTE:§These menu items do not use the check mark like the standard Macintosh style menu. If text is selected a checkmark will not appear to the left of the appropriate style(s).
The first three options change text style. If text is selected to be placed into a HyperQueue then any text style will be _maintained_ and _will_ be reset when a word is removed from a Queue or a Queue is erased.
The third option is to change selected text to 18 point size. Text that is changed with this option will retain its size even if it is placed in a Queue. When and if text size is changed from the Waldo menu it has no effect on text set to 18 point with this option.
The forth option is to lock the text so that size and font may not be changed. See "Lock Text" for more information.
The fifth option will hide the Text menu.
§NOTE:§When the Text menu is visible then the text may be edited and all changes are permanent (within Waldo). Be very careful if you have created any HyperQueues for the document as any editing of the document will "through off" the Queues. It is better to alter text first and only then to add HyperQueues.
^
*Lock Text*
The forth option of the Text menu will lock the Waldo so that Font menu and the Change Text Size option in the Waldo menu will be hidden. This will allow for critical formatting of text on the Page. This way the reader will not be able to change the appearance of the text in Waldo. Remember that the font chosen for the text is critical when locking text as text will not display the same on all computers unless that font is available for that computer. If you are not using one of the "system" fonts for the Macintosh you may use a nonstandard font by including the font resource inside of the Waldo you are transferring. (This is done with a program such as Apple's ResEdit but note that Apple discourages this.) Be sure you have permission from the publisher of the font(s) to do this. Then the fonts reside in the Waldo and do not have to be present in the readers system folder for him to have them displayed in the Waldo. I do not advise putting fonts inside of Waldo.
^
*CopyText*
This function of the OpenBook dialog will, when Yes shows, allow the reader to copy text from a document Page as well as use the Print Report function from the File menu. When NO shows then the reader will NOT be able to copy text or use the Print Report function in the File menu.
^
|
*|OpenBook Features Explained|*
^
*Loading files into Waldo*
OpenBooks will not load text and text in an OpenBook can not be erased. This is not a permanent situation. If you unlock the Waldo then text may be loaded and erased from the Waldo. You will loose any editing and formatting you did to the text while in the locked state if you erase the document. An OpenBook may still have text copied from a page and Pages may be printed using the "Print Report..." option in the File menu. But the reader will not be able to delete text from the Waldo or export it to a text file.
NOTE: If you set Copy Text, from the OpenBook dialog, to NO then the reader will not be able to copy text or print the text using the Print Report menu function in the File menu.
^
*XRes stack scripts*
If the author chooses to lock Queues into OpenBook then if the Queues have XRes associated with them then the author§must§ be sure to follow instructions for loading the script into Waldo.
NOTE: You may name a Queue but if there are no Spots in a Queue then it will not be locked.
When locking Waldo (OpenBook) a dialog is presented. If HyperQueues are loaded in Waldo at the time you are locking Waldo they will also be locked. (They will unlock when Waldo is unlocked.) You will be asked from within a get file dialog to select the XRes stack for loading.
§NOTE:§When locking Waldo any XStack buttons will be locked. The reader may add and delete their own XStack buttons.
§NOTE:§ Inversion 3.3.7 and later there is no "Open stack in new window" check box!
Click Cancel only if any HyperQueues have NO XRes!
Waldo will load the script from the stack script of the XRes stack into a hidden field in the Waldo. XRes handlers will be run from within a OpenBook.
§NOTE:§When a OpenBook is unlocked (Waldo) then any XRes script and resources loaded are erased at this time. And will have to be reloaded when the Waldo is locked again.
Be sure you follow the procedure for writing scripts and structuring handlers for XRes--see Waldo documentation.
^
*Unlocked XRes in a Locked Waldo (OpenBook)*
You may still have XRes stacks that function with OpenBook provided that you leave some HyperQueues unused (empty) when you lock Waldo (OpenBook). But instead of functioning from the level of the document loaded they function from the same level as the OpenBook. It may be wise to remind readers of this especially if they are already familiar with unlocked Waldos. Remember readers may construct stand-alone XRes stacks for OpenBooks that have unlocked HyperQueues available.
^
*OpenBook Stack Help stacks*
Waldo stack help is accessed from the Waldo level not the document level. Remember that in a Waldo you may include a stack of your construction called (name of document loaded)&Help eg., NewsHelp. That stack in a Waldo must be at the same level, on your hard drive, as the document loaded into the Waldo. In an OpenBook it resides at the same level as the OpenBook. The help stack is accessed the same as an XStack and there are no restrictions placed on it other than a return function as is necessary in an XStack to return to Waldo. The help stack will be available from any page in OpenBook/Waldo.
^
*Page Level Graphics*
In OpenBook you may unlock the paint tools from the dialog. You may use the paint tools to paint graphics on the card layer or import a MacPaint graphic.
When the paint tools are unlocked you may access the tool palette
by holding down the option key and pushing the tab key--repeat to hide the tools. While a paint tool is selected push the tab key by itself to show and hide the pattern palette.
In OpenBook (locked Waldo), not in Waldo (ShareWare), you may paint an image in a specific area on the Front Page. This is for placing information about the "book," author and publisher. The graphics may not cover or touch any of Waldo's graphics or text. The graphics must be confined to a rectangle within the white area above the table of contents on the Front Page. The bottom line of the imagined rectangle would be inline with the bottom of the first line of the copyright notice at the top left of the Front Page.
The author may choose to paint graphics on any other Page, except tables of contents, as long as the painting is restricted to the rectangle of the text field.
If you do include Page level Graphics you §MUST§enable the HideGrph in the OpenBook dialog.
^
*More About Page Graphics*
Graphics may completely cover the text of a document Page or may only partially cover it. The text field may contain as little or as much text as the author wishes. It may be transparent or not.
§NOTE:§The author may choose to set up a Page with only two asterisks (a no-text title) and a caret to mark the title and end of Page. When loaded the Page will contain no text as the asterisks are lost when the Page is loaded.
The author may choose to carefully format the text on a Page to accommodate the Page graphics and then lock the text to insure that the text keeps it position on the Page relative to the graphics. When the text is clicked on Waldo responds by hiding the graphic and then responding with the appropriate action. Page Graphics basically have no effect on the functioning of text. The author may elect to "erase" holes in Graphics to reveal text underneath. Do not forget the functional differences between "painted text" and "real text" and strive to use the differences to achieve your particular goals.
^
*Different Help and Copyright*
When a Waldo has been locked (OpenBook) then a different copyright notice from ShareWare Waldo is displayed when Waldo is opened. There is a different help screen on the Front Page than the one displayed in ShareWare Waldo. The help screen only displays functional and navigational information in OpenBook and no construction data.
The Waldo help stack is available from the same level as the Waldo/OpenBook.
